home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / WINDOWS / EDITORS / ZAPEDIT / README.TXT next >
Text File  |  1991-01-29  |  8KB  |  180 lines
  1.   README.TXT     ZapEdit 1.0 (c) Cleveland Associates 1991
  2.  
  3.  
  4.  
  5.      Welcome to ZapEdit!  ZapEdit is an editor for Microsoft
  6. Windows programmers.  ZapEdit allows programmers to write MS
  7. Windows programs in C (or any other language) and compile and debug
  8. them without ever leaving the Windows environment.  It was designed
  9. by a programmer who got tired of constantly switching to DOS to
  10. edit program files or to run the make utility.  Everything can be
  11. done from within ZapEdit, including compiling the program, running
  12. it, and invoking the debugger.  ZapEdit also has several nice
  13. features including a Multiple Document Interface (MDI) which allows
  14. the programmer to open several files at once and cut and paste at
  15. will.
  16.  
  17.  
  18. /*************************************************************
  19.  
  20.      ZapEdit is shareware, which means that you can use it, copy
  21. it, and give it away to anyone you like.  
  22.  
  23.     If you use ZapEdit and like it, you are encouraged to register
  24. your copy for $25.  When you register you will receive our sincere
  25. thanks, a manual, and the next release of the program.  We plan to
  26. add several fancy new features in the very near future.  For $100
  27. you will receive the source code and will be able to modify it to
  28. include any features you like.  Please do not sell the program or
  29. use it in a commercial enviroment without registering it.
  30.  
  31.      Please send your questions, comments, and registration fees
  32. to:                 
  33.                     Cleveland Associates
  34.                     623 Surf Street, #2W
  35.                     Chicago, Illinois  60657
  36.  
  37.      Cleveland Associates is a consulting and programming firm that
  38. can provide assistance in Windows and C-language applications
  39. development.
  40.  
  41. ******************************************************************/
  42.  
  43.      ZapEdit works much like any other Windows application -- it
  44. has menus, dialog boxes, the works.  Most of the control keys are
  45. Common User Access (CUA) compliant.  While those of us who grew up
  46. on WordStar find the adjustment to different editing keys a little
  47. hard to take, this interface is logical, consistent, and does make
  48. editing go much quicker.  If you really would like to reconfigure
  49. some keys, you can order the source code and modify it very easily. 
  50. Adding new control keys is a snap.
  51.  
  52.      Most of the menu options are similar to the ones in the
  53. Windows Notepad application.  I have included some brief notes on
  54. them and on some general tips for faster editing:
  55.  
  56. FILE MENU
  57.      New  -- New does not clear an old document on the screen; it
  58. simply opens a new window and names it "Untitled".  To clear an old
  59. document, double click on its system box in the upper left-hand
  60. corner.
  61.  
  62.      Open -- You can open new windows quickly and easily by using
  63. the F2 key.  Press F2 to open the "Open" dialog and Tab to the
  64. listbox of files.  No need for your hands to leave the keyboard for
  65. the mouse.
  66.  
  67.      Save, Save As -- These apply to the current window only.  You
  68. can save files selectively.
  69.  
  70.      Print, Print Setup -- Standard menu options.  Print uses the
  71. default font for your printer.  It does not acknowledge any screen
  72. fonts that you may be using (see below for info on fonts).
  73.  
  74.      Short Menus, Exit, About ZapEdit -- Standard menu options.
  75.  
  76. EDIT MENU
  77.  
  78.      Undo, Cut, Copy, Paste, Delete, Select All -- These options
  79. work like they do in any Windows application.  You can insert blocks
  80. of text from the disk by using F2-Open, Select All, Cut, switch back 
  81. to your old window, and Paste.  The next version of the program will 
  82. have a faster method for this operation.  You can write blocks to disk 
  83. by Selecting text, opening a New window, Pasting it, and doing a Save 
  84. As.  All cutting and pasting is done into the Windows clipboard so 
  85. you can transfer text back and forth with other applications as well.
  86.  
  87.      WordWrap -- Applies only to the current window.  Toggle it on
  88. and off.
  89.  
  90.      Fonts --  You can select the font and size that you prefer to
  91. use when editing.  Some fonts are easier to read than the system
  92. font -- Courier is a good choice.  Courier also has the advantage
  93. that it is a fixed-pitch font, which means that you can use it to
  94. make sure that your columns line up evenly.  Variable-pitch fonts
  95. leave jagged columns.  Your choice of font and size is saved in
  96. the WIN.INI file and comes up automatically the next time that you 
  97. run the program.  When you set a font it applies to all windows -- 
  98. it is not possible (in this version) to have different fonts in 
  99. different windows.
  100.  
  101.  
  102. SEARCH MENU
  103.  
  104.      Find, Next, Previous -- Standard search functions.  To do a
  105. search-and-replace, type your replacement string into a window and 
  106. cut it into the clipboard.  Run the search, and everytime an 
  107. occurence is found press Shift-Insert to replace the text.  Note 
  108. that the search routine starts at the caret position, not at the 
  109. beginning of the file or at the mouse pointer position.
  110.  
  111.  
  112. RUN MENU
  113.  
  114.      The Run Menu allows you to run, compile, and debug
  115. applications with a single keystroke.  To use this feature, you
  116. must first select the Run Setup option and type in some command
  117. lines.  Typical command lines are:
  118.  
  119.      Run Command String:
  120.      c:\myprogram\myprogram.exe parameter1 parameter2
  121.  
  122.      Make Command String:
  123.      make c:\myprogram\myprogram
  124.  
  125.      Debug Command String:
  126.      cvw c:\myprogram\myprogram.exe
  127.  
  128.      These commands should be typed just as you would type them on
  129. the DOS command line.  When in doubt, precede all filenames with
  130. the full path.  These lines are saved in WIN.INI and are loaded 
  131. automatically when you run ZapEdit.
  132.  
  133.      Each of these commands are executed as child processes without
  134. disrupting anything that is going on in ZapEdit.  ZapEdit will
  135. automatically save the current window to disk when you select Make,
  136. but will not move the cursor or otherwise affect the current file. 
  137. This fact makes it possible to make and run your program using only
  138. two keystrokes without losing your editing place.
  139.  
  140.      Make.exe is a DOS program whose execution is controlled by
  141. its .PIF file.  If you are running on a 80286 machine or lower,
  142. Make will force Windows to blank the screen and shell out to DOS. 
  143. If you are running on a 80386 or higher, you have the option of
  144. creating a .PIF file for Make that will redirect Make's output to
  145. a window.  Use the PIF editor that comes with Windows to create
  146. .PIF files.
  147.  
  148.      When the make program is finished executing control will be
  149. returned to ZapEdit.  Sometimes you will want to pause Make when
  150. it is finished so that you can read any error messages before they
  151. disappear.  To do this, create a batch file (MAKEIT.BAT) with the
  152. following lines:
  153.  
  154.      make c:\myprogram\myprogram
  155.      pause
  156.  
  157. and enter "makeit.bat" on the make command line in Run Setup.  Be
  158. sure to include the .bat extension because Windows assumes that all
  159. executables end with .exe unless otherwise specified.  
  160.  
  161.      If you have multiple windows open when you run make, be sure
  162. to save any of them that will be used during compiling or linking. 
  163. ZapEdit automatically saves only the current window.  Make will use
  164. the old versions of the files still on disk if they aren't saved.
  165.  
  166.  
  167. FUTURE ENHANCEMENTS
  168.  
  169.      It is likely that the next version of ZapEdit will include most 
  170. of these enhancements:
  171.  
  172.      Capacity to handle larger files
  173.      Display for current line and column
  174.      A better search and replace
  175.      Auto indenting for code blocks
  176.      One-key access to the SDK online reference
  177.      Custom tabs
  178.  
  179.      Please mail any suggestions or requests to Cleveland
  180. Associates at the address above.  Happy Computing!